home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / xmartin-2.2 / README < prev    next >
Text File  |  1995-05-03  |  5KB  |  120 lines
  1. Xmartin 2.2 - grandson of xfroot - 24 July 1991 
  2. -----------------------------------------------
  3. Ed Kubaitis (ejk@ux2.cso.uiuc.edu)
  4.  
  5. DISCLAIMER: This software is provided "as is" and with no warranties 
  6.         of any kind.
  7.  
  8. Xmartin is an X11 root window decorator based on the Barry Martin hopalong
  9. algorithm (see A. K. Dewdney's column in the 9/86 Scientific American.)
  10. See the HISTORY file for changes since xmartin 2.1.
  11.  
  12. Installation Instructions
  13. -------------------------
  14. The materials include both an Imakefile and a simple makefile (xmartin.mk).
  15. Review the one you intend to use and make any changes needed for your 
  16. environment. 
  17.  
  18. Xmartin is very floating-point intensive. Be sure to include in CFLAGS
  19. any options to improve floating-point performance (eg: -f68881 on Sun 3's.)
  20.  
  21. If your system does not have perl(1) installed, you may want to comment out
  22. the lines having to do with "xmartin+". If you have perl but it is not in 
  23. /usr/bin/perl, modify the first line of xmartin+.pl. 
  24.  
  25. If you find it necessary to modify the source code to get xmartin to compile 
  26. or execute correctly, I'd appreciate hearing about the problem and what you 
  27. did to get around it. I'd also appreciate hearing about success on platforms
  28. other than those below.
  29.  
  30. Xmartin has been built & tested on the following client platforms:
  31.  
  32.     o IBM RS/6000 540 AIX 3.1.6 - (X11R4) Perl 4.010
  33.     o Convex 240 9.0 OS (X11R4) Perl 4.010
  34.     o Sequent Symmetry S81 Dynix 3.0.17.7 (X11R4) Perl 4.010
  35.     o Sun 3/50 SunOS 3.5 (X11R4)
  36.     o Sun 3/60 SunOS 4.1 (X11R4)
  37.     o VaxServer 3500 BSD 4.3/Reno gcc (X11R4) Perl 3.37
  38.     o Apollo 425t DomainOS 10.3.4 unoptimized cc (X11R3) 
  39.     o VaxServer 3500 Ultrix-32 V3.0(Rev 64) (X11R4) Perl 3.15
  40.     o Cray 2 Unicos scc (X11R3)
  41.  
  42. And with the following servers:
  43.  
  44.     o NCD 19 monochrome - X11R3
  45.     o Sun 3/50 monochrome - X11R4
  46.     o Sun 3/60 color - X11R4
  47.     o Visual Turbo X-19 grayscale - X11R4
  48.     o IBM RS/6000 320 color - X11R3
  49.     o IBM Xstation 120 grayscale - X11R3
  50.     o IBM Xstation 120 color - X11R3
  51.  
  52.  
  53. Using xmartin
  54. -------------
  55. After installation, the unadorned command 'xmartin' should set your root 
  56. window to one of the roughly 1e64 basic hopalong patterns. Review the man 
  57. page for options you may want to try. 'xmartin help' or 'xmartin+ help' 
  58. yield a concise synopsis of options.
  59.  
  60. On clients without strong floating point performance, try '-tile' which
  61. reduces calculation time by a factor of 2 to 64, and produces some pleasing
  62. effects as well.
  63.  
  64. Using xmartin+
  65. --------------
  66. On systems with perl, several additional features are available with the
  67. xmartin+ front end to xmartin. Executing xmartin+ will create a ~/.xmartin+ 
  68. file with entries you can modify to tailor the random probabilities and
  69. parameter ranges hardwired into xmartin. The file has comments describing
  70. its format and several sets of xmartin parameters you can request by name by
  71.  
  72.           xmartin+ -n name
  73.  
  74. 'xmartin+ -q' lists the names available. 'xmartin+ -demo' will invoke xmartin
  75. once for each name.  (If you don't have perl, you can peek at these parameter
  76. sets in the xmartin+.pl source.) I'd appreciate hearing about any interesting
  77. parameter sets you discover.
  78.  
  79. xmartin+ also has options to save an interesting pattern in ~/.xmartin+ and to
  80. generate patterns repeatedly.
  81.  
  82. About perl: perl is a language devised by Larry Wall with most of the features
  83. of new awk, sed, tr, shell scripts, and C -- sort of one-stop shopping for 
  84. things you don't want to do in C. It has it's own newsgroup (comp.lang.perl)
  85. and O&A Nutshell book: Programming Perl (info: 1-800-338-6887.) The source 
  86. is freely available (jpl-devvax.jpl.nasa.gov in pub/perl.4.0/kits@0). It 
  87. builds easily on most un*x platforms and can usually be coaxed on the others.
  88.  
  89.  
  90. Acknowledgements
  91. ----------------
  92.    o Clifford Pickover (cp1 sine sculptures)
  93.    o Renaldo Recuerdo (rr1 algorithm & other suggestions)
  94.    o Kevin Meek & Ranjan Bagchi (tvtwm support)
  95.    o Bob Bubon (DEC window manager support)
  96.    o David Elliot (multiple screen support)
  97.    o Robert Forsman (example code for reducing color intensity)
  98.    o Thomas Breuel (background color suggestion)
  99.    o Jon Stone (-p/-P %-of-pixels suggestion)
  100.    o Michael Traub (X-Vision/Sequent testing, color parse fix)
  101.    o Wayne Richardson (RT 4.3 compile fix)
  102.  
  103.  
  104. Quotes
  105. ------
  106.  
  107.        Clearly these curious configurations show us that the rules 
  108.        responsible for the construction of elaborate living tissue 
  109.        structures could be absurdly simple.
  110.  
  111.                                 --Barry Martin
  112.  
  113.        ...delicately poised between random smoke and severe geometry.
  114.  
  115.                               --Clifford Pickover
  116.  
  117. ----------------------------------
  118. Ed Kubaitis (ejk@ux2.cso.uiuc.edu)
  119. Computing Services Office - University of Illinois, Urbana
  120.